/*
 * Copyright 2002-2018 the original author or authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      https://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package org.springframework.aop;

import org.springframework.lang.Nullable;

/**
 *  一个{@code TargetSource}被用来获取当前AOP调用的 "目标"。
 *  AOP调用的当前 "目标"，如果周围没有人选择结束拦截器链，它将通过反射来调用。
 *  建议选择结束拦截器链本身。
 *
 * 如果一个{@code TargetSource}是 "静态的"，它将总是返回相同的目标，允许在AOP框架中进行优化。
 * 动态的目标源可以支持池化、热交换等。
 *
 *应用程序开发人员通常不需要与{@code TargetSources}直接工作：这是一个AOP框架接口。
 *
 * @author Rod Johnson
 * @author Juergen Hoeller
 */
public interface TargetSource extends TargetClassAware {

	/**
	 * 返回由这个{@link TargetSource}返回的目标的类型。
	 * 可以返回{@code null}，虽然某些使用{@code TargetSource}的情况下的某些用法可能只适用于一个预定的目标类。
	 * @return 该{@link TargetSource}返回的目标的类型。
	 */
	@Override
	@Nullable
	Class<?> getTargetClass();

	/**
	 * 所有对{@link #getTarget()}的调用都会返回同一个对象吗？
	 * 在这种情况下，将不需要调用{@link #releaseTarget(Object)}。
	 * 并且AOP框架可以缓存{@link #getTarget()}的返回值。
	 * @return {@code true} 如果目标是不可变的
	 * @see #getTarget
	 */
	boolean isStatic();

	/**
	 * 返回一个目标实例。
	 * 在紧接着AOP框架调用一个AOP方法的 "目标 "之前立即调用。
	 * @return 包含连接点的目标对象。
	 * 			如果没有实际的目标实例，则返回{@code null}。
	 * @throws Exception 如果目标对象不能被解析
	 */
	@Nullable
	Object getTarget() throws Exception;

	/**
	 * 释放从以下方法获得的目标对象{@link #getTarget()}方法获得的目标对象，如果有的话。
	 * @param target object obtained from a call to {@link #getTarget()}
	 * @throws Exception if the object can't be released
	 */
	void releaseTarget(Object target) throws Exception;

}
